The prerequisites for checking with a User dictionary are as follows:

• A properly prepared User dictionary file
• A call to IG_REC_UD_set()
• Zones referring to sections in the User dictionary (if not, the default section of the User dictionary is required)

The checking subsystem can handle two kinds of User dictionaries: native dictionary files (created or updated by a previous IG_REC_UD_save() call), and word-list file. The way of preparing a native User dictionary file is given in the next topic. A word-list file is a text file; it contains words, one in each line.

Before recognition, the IG_REC_UD_set() function must be called with the name of the User dictionary file and also with a section name. This section name defines the default section in the User dictionary. The items under this section will be "used" by any AT_REC_ZONE in the zone list whose UserDictionarySection field contains an empty string. (Note that the auto-zoning function always creates zones with an empty string in this field.) Other sections in the User dictionary can be referred to by name. In this case, for those zones where it is needed, the UserDictionarySection field must contain the section name. This way different zones on a page can be UD-checked with different sections. A zone will be subject to UD-checking only if the IG_REC_ZCF_USERDICT_PROHIBIT flag of its Checking field is off.

Configuring the Checking Subsystem to Enable UD Checking

C	Copy Code
AT_ERRCOUNT nErrCount; nErrCount = IG_REC_spelling_is_enabled_set(TRUE); nErrCount = IG_REC_correction_is_enabled_set(TRUE); nErrCount = IG_REC_UD_set("MYWORDS.DCT", "DEFSECT");

After recognition, the Checking field of the zones might be updated by one of the flags IG_REC_ZCF_LANGDICT_USED, IG_REC_ZCF_USERDICT_USED , IG_REC_ZCF_CHECKCBF_USED, or IG_REC_ZCF_VERTDICT_USED.